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MANAGING CODE CHANGES FOR SOFTWARE DEVELOPMENT 



Technical Field 

5 The present invention relates to electronic data processing, and more particularly 

concerns the integration of code changes made by different developers into consistent 
modules. 



Background 

1 0 The development of application programs, operating systems, and other complex 

software involves the cooperative effort of large numbers of individuals and groups of 
individuals working on hundreds or even thousands of interdependent modules over long 
periods of time. La the 1970s, companies that created such programs began deliberate 
efforts to create organizational frameworks and systems of programs to manage long and 

15 complex development cycles. More recently, programs for managing software 
development projects have become available for licensing to smaller institutions. 

The major part of systems for developing software concerns systems for 
controlling different versions of the source code for the software. A source-control 
system typically includes of several pieces, almost always including a storage engine that 

20 provides efficient versioned storage of files, a differencing/merging engine for combining 
different versions of the same file, modules for operating upon multiple file formats such 
as text documents and Unicode, and user interfaces for various parts of the system, 
including those for differencing and merging. 

Change management is the overall process of keeping track of modifications in 

25 source-code and other versioned documents across time and across multiple development 
groups working in parallel with each other. As programs become larger and more 
complex, change management becomes increasingly necessary to minimize errors and 
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conflicts across code modules from different versions and from different groups. Even 
development systems offered to smaller organizations need much more sophisticated 
change-management techniques. Relatively primitive conventional merging or 
differencing (these terms are synonymous in the art) methods are no longer adequate, for 
5 example. Developers often desire to deal with collections of changes as entities, rather 
than manipulating them individually. Also, conventional development systems do not 
deal adequately with temporary patches made when modules are assembled into a build 
for testing the complete program. 

10 Summary 

The present invention offers greater capabiUties in change management for 
software development systems, in a way that allows even smaller systems to benefit. 

An aspect of the invention provides better ergonomics and increased speed in 
merging versioned documents by indicating differences between them at multiple 
15 different subdivisions or levels, such as line and character levels. 

Another aspect of the invention increases the rehabihty of merges between 
documents by comparing them not only for incompatible changes with respect to each 
other, but also by detecting possible alternative histories from a common parent 
document, and flagging these as potential conflicts. 

20 Another aspect increases flexibility in reverting to previous versions by removing 

changes made during an earher version to be backed out from a current version while 
retaining changes made in a version later than the removed version but earlier than the 
current version. 

A further aspect of the invention increases the ability to integrate all the material 
25 pertaining to a change, by keeping it together in one place. This aspect associates both 
versioned and nonversioned documents for the same version together, so that they can be 
manipulated as a single unit. 

Yet a further aspect permits developers to work in together in constructing a new 
build of the software even while another build is being tested and patched. Multiple 
30 copies of the documents are made in different areas. While one set of copies is built and 
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tested, private copies for each builder have previous changes removed, so that they can 
modify clean copies of the documents. 

Drawing 

5 Fig. 1 is a block diagram of an illustrative environment for hosting the invention. 

Fig. 2 is a high-level overall diagram of a development system in which the 
invention can be practiced. 

Fig. 3 is a flowchart of a method for merging documents at multiple levels 
according to the invention. 

10 Fig. 4, comprising Figs. 4A and 4B, shows a method for merging multiple 

documents according to the invention. 

Fig. 5 depicts a method for recovering previous versions of development 
documents according to the invention. 

Fig. 6 is a symbolic diagram of a system for processing changes to multiple 
1 5 documents as a unit according to the invention. 

Fig. 7 is a flowchart of a method for handling changes to the multiple documents 
of Fig. 6 

Fig. 8 is a block diagram of a system for manipulating changes made for a 
program build according to the invention. 
20 Fig. 9 is a flowchart of a method employing the system of Fig. 8. 
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Detailed Description 

This description and the accompanying drawing illustrate specific examples of 
embodiments in which the present invention can be practiced, in sufficient detail to allow 
those skilled in the art to understand and practice the invention. Other embodiments, 
5 including logical, electrical, and mechanical variations, are within the skill of the art. 
Skilled artisans will also recognize features and advantages of the invention other than 
those exphcitly set forth. The scope of the invention is to be defined only by the 
appended claims, and not by the specific embodiments described below. 

10 Environment 

Fig. 1 is a high-level diagram of an illustrative environment 100 having software 
110 and hardware 120 for hosting the invention as executable instructions, data, and/or 
electronic and mechanical components. Other suitable environments, and variations of 
the described environment are also possible. 

15 Hardware components 120 are shown as a conventional personal computer (PC) 

including a number of components coupled together by one or more system buses 121 for 
carrying instructions, data, and control signals. These buses may assume a number of 
forms, such as the conventional ISA, PCI, and AGP buses. Some or all of the units 
coupled to a bus can act as a bus master for initiating transfers to other units. Processing 

20 unit 130 may have one or more microprocessors 131 driven by system clock 132 and 
coupled to one or more buses 121 by controllers 133. Intemal memory systeml40 
supplies instructions and data to processing unit 130. High-speed RAM 141stores any or 
all of the elements of software 110, ROM 142 commonly stores basic input/output 
system (BIOS) software for starting PC 120 and for controlling low-level operations 

25 among its components. Bulk storage subsystem 150 stores one or more elements of 

software 110. Hard disk drive 151 stores software 110 in a nonvolatile form. Drives 152 
read and write software on removable media such as magnetic diskette 153 and optical 
disc 154. Other technologies for bulk storage are also known in the art. Adapters 155 
couple the storage devices to system buses 121, and sometimes to each other directly. 

30 Other hardware units and adapters, indicated generally at 160, may perform specialized 
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functions such as data encryption, signal processing, and the Uke, under the control of the 
processor or another unit on the buses. 

hiput/output (I/O) subsystem 170 has a number of specialized adapters 171 for 
connecting PC 120 to external devices for interfacing with a user. A monitor 172 creates 
5 a visual display of graphic data in any of several known forms. Speakers 173 output 
audio data that may arrive at an adapter 171 as digital wave samples, musical-instrument 
digital interface (MIDI) streams, or other formats. Keyboard 174 accepts keystrokes 
from the user. A mouse or other pointing device 175 indicates where a user action is to 
occur. Block 176 represents other input and/or output devices, such as a small camera or 

10 microphone for converting video and audio input signals into digital data. Other input 
and output devices, such as printers and scanners commonly connect to standardized 
ports 177. These ports include parallel, serial, SCSI, USB, FireWire, and other 
conventional forms. 

Personal computers frequently connect to other computers in networks. For 

15 example, local area network (LAN) 180 connect PC 120 to other PCs 120' and/or to 

remote servers 181 through a network adapter 182 in PC 120, using a standard protocol 
such as Ethemet or token-ring. Although Fig. 1 shows a physical cable 183 for 
interconnecting the LAN, wireless, optical, and other technologies are also available. 
Other networks, such as wide-area network (WAN) 190 can also interconnect PCs 120 

20 and 120', and even servers 181, to remote computers 191. Computers 181 and 191 have 
processors, storage, and communications equipment similar to those of PC 120, although 
usually of higher capacity. Fig. 1 illustrates a communications facihty 192 such as a 
pubhc switched telephone network for a WAN 190 such as an intranet or the internet. PC 
120 can employ an intemal or external modem 193 coupled to serial port 177. Other 

25 technologies such as packet-switching ISDN, ATM, DSL, frame-relay are also available. 
In a networked or distributed-computing environment, some of the software 110 may be 
stored on the other peer PCs 120', or on computers 181 and 191, each of which has its 
own storage devices and media. 

Software elements 1 10 maybe divided into a number of types whose designations 

30 overlap to some degree. For example, the previously mentioned BIOS sometimes 
includes high-level routines or programs which might also be classified as part of an 
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operating system (OS) in other settings. The major purpose of OS 1 1 1 is to provide a 
software environment for executing apphcation programs 112 and for managing the 
resources of system 100. An OS such as Microsoft® Windows® or Windows NT® 
coEomonly implements high-level application-program interfaces (APIs), file systems, 
5 communications protocols, input/output data conversions, and other functions. 

Application programs 112 perform more direct functions for the user. A user 
normally calls them explicitly, although they can execute implicitly in connection with 
other applications or by association with particular data files or types. Modules 113 are 
packages of executable instructions and data which may perform fimctions for OSs 111 

10 or for applications 1 12. Dynamic link libraries (.dll) and class definitions, for instance, 
supply fimctions to one or more programs. Data 114 includes user data of all types, data 
generated and/or stored by programs, and digital data that third parties make available on 
media or by download for use in computer 120. Software elements can be embodied as 
representations of program instructions and data in a number of physical media, such as 

15 memory 140, non- volatile storage 150, and signals on buses 183, 192, etc. 

Fig. 2 is a high-level overview of an illustrative software-development system 
200, such as Visual Studio®, pubUcly available fi-om Microsoft Corp. A client 210 
manages the components of the system, passing data and commands among them. User 
interface 220, which may comprise input/output devices such as 170, Fig. 1, receives 
20 commands from a user and displays data to the user. Editor 230, which may take the 

form of an external general-purpose text processor, allows the user to display and modify 
development documents 101 containing source code, metadata, and other information. 

The overall merge subsystem 240 handles the merging or differencing of two or 
more documents to determine conflicts among different versions, and for other purposes. 

25 The terms merging and differencing are often used synonymously. For the present 

purposes, these terms are also taken to include an "unmerging" function to be described 
later. In the present system, the overall merge subsystem includes a merge broker 241 
that can find and select among multiple merge processes 242, 243, etc. The broker can 
select a process in response to a parameter in a merge command, or in other ways, such 

30 as the format of the documents to be merged. In this embodiment, broker 241 is a fixed 
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part of the system; processes 242 and 243 include merge engines, merge preprocessors, 
and merge postprocessors, each of which can be a replaceable module in the system. 

Some development systems also include a keyword expander 250 for inserting 
and processing tags in development documents. Tags represent metadata, that is, 
5 information about the document, rather than actual code or other content. Blocks 260 
represent other functions and services provided by a software-development system. More 
than one service of a given type can be included. For example, different editors might 
handle documents having different formats. 

A version store 270 holds documents 201 and other files and information 
10 pertaining to the system and to development projects. (The terms ^'document" and "file" 
are considered synonymous herein.) Normally, even a relatively small project has 
dozens, hundreds, or even thousands of documents associated with it. A version store 
typically comprises a file system dedicated to the development system, although it may 
employ the underlying structure of an operating system 111 and physical storage 
15 subsystem 150 of its host computer 120, Fig. 1. In larger system, physical storage may 
be physically located in a server such as 180 or 190. 

The components of most development systems are tied together with speciaHzed 
interfaces that differ for each component. Copending U.S. patent application Ser. No. 

, filed (Attomey docket 777.335US1) discloses an improved 

20 development-system architecture in which the present invention can also be carried out, 
and is hereby incorporated by reference. 

Multilevel Merging 

Fig. 3 is a flowchart of a method 300 for merging documents according to the 
25 invention. The method can be executed within merge subsystem 240, Fig. 2. 

Differencing two documents — ^that is, displaying the differences between them — 
is conventionally performed in one or the other of two ways. Line-level differencing 
detects the fact that the corresponding lines of the documents to be merged have at least 
one difference fi'om each other. This technique is fast, because the units of comparison 
30 are larger. It also has ergonomic advantages. A line of text frequently corresponds to a 
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line of code, a complete command, or other lexical unit. Therefore, displaying changed 
lines exposes the semantics of the changes, the context in which a change has occurred. 
Character-level differencing pinpoints the actual characters that differ between the 
documents, and reduces eyeball search time to find the exact places at which changes 
5 have occurred. 

Method 300 achieves the advantages of both line- and character-level 
differencing, and adds other levels as well. According to the invention, documents can 
include characters, symbols, or other indicia that divide them into sections. Although the 
significance of the sections is arbitrary, they can usefully correspond to functions, blocks, 
10 or other semantic units of a program or module. Method 300 illustrates one embodiment; 
the invention can employ more or fewer levels of differencing, and the levels can have 
any desired significance, other than or in addition to characters, lines, and sections. 

If block 310 determines that the documents are divided into sections, then blocks 
320 compare them section by section. Block 321 iterates through the sections. Block 

15 322 compares the current section of one document with the same section of the other 
document. If block 323 detects any difference between the documents at this level, then 
block 324 identifies the section. This can be by generating an enumeration of 
differences/merges in the document, in the form of a rowset containing the information, 
producing an automatic merge having text markers indicating the conflicts, or some other 

20 operation. If the documents have no section, then block 310 transfers control to blocks 
330. 

Blocks 330 compare the lines of the documents within the current section if it has 
any differences at the section level. Block 331 iterates through each line in the section 
(or in the whole document if there are no sections). Block 332 compares the current line 

25 of one document with a corresponding Une of the other document. If block 333 detects 
any difference between the documents within the current line, then block 334 identifies 
that line. If there are many differences between these lines, then identifying the 
individual characters is frequently not helpful to the user. In this event, block 335 omits 
the character-level comparison, returning directly to block 331. When all lines have been 

30 compared, control returns to block 321 . 
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Blocks 340 compare the characters of the current Hne if it has some (but not too 
many) differences at the line level. Block 341 iterates through each character in the 
current line. Block 342 compares the current character of one document with the 
corresponding character of the other document. If block 343 detects any difference 
5 between the documents within the current line, then block 344 identifies that line. When 
all lines have been compared, control returns to block 331. When all iterations have 
completed, line 302 returns a merged document or rowsets, with the differences between 
the input documents identified. 

Method 300 illustrates one embodiment having three levels of merging 
10 documents. More or fewer levels can participate in this multi-level procedure in other 
embodiments. The levels can correspond to divisions of a document other than 
characters, lines, and sections, if desired. Besides allowing multiple levels of differences 
to be indicated within the same process, method 300 has the advantage of speed. When a 
line of the input documents has no differences, character-level searching can be skipped 
15 altogether for that line. If sections are employed, then no line or character searching need 
be performed for a section that has no differences. Even though a computer must at some 
level compare individual characters to perform higher-level searches, such comparisons 
can almost always be executed with low-level string or block comparison instructions 
that are much faster. A third advantage is that some algorithms can only be usefully 
20 applied to small amounts of data. For example, in one embodiment, a line differencing 
algorithm only provides useful results if the lines are shorter than about 1000 characters. 
Getting smaller pieces hke this is only possible using the multilevel block structure 
described above 



25 Reliable Merging 

Fig. 4 illustrates a more rehable merge of two input documents. A merge 
operation compares two files and detects any differences. For each difference, a 
determination is made as to whether or not it is safe to automatically merge the changes. 
For example, independent changes to unrelated lines are safe to merge. A conflict occurs 
30 for different changes to a common area— e.g., where two people have changed the same 



9 



line in different ways. Users then review the conflicts and can have the safe merges 
automatically applied. A merge operation creates a composite of the two files 

In some cases, however, changes that appear compatible might in fact conflict 
with each other, because altemative interpretations of the file exist. In these case, one 
5 interpretation would say that the changes are compatible, and it it safe to merge the files. 
But another possible interpretation would determine that the changes had occurred in a 
way that raises a conflict among them. Prior merge systems do not detect these cases, 
and therefore can automerge changes that in fact conflict with each other and should be 
resolved manually. 

10 Fig. 4A symbolizes an example of such a situation. Files 401 and 402 were 

modified independently by two different developers from a common root 403, Files 401 
and 402 differ from each other. The blocks in Fig. 4A represent groups of characters, 
lines, or other units in the files that have been identified as being the same or different in 
the other files. The block marked "X" represents a group in root file 403 that was deleted 

15 from both of the modified files 401 and 402. The differences, however, could have 
resulted from different editing actions. The solid arrows represent one possible 
interpretation of the changes; the dashed arrows represent a different possible 
interpretation of the line groups from the root file. One of the interpretations is safe to 
automerge files 401 and 402, but the other interpretation produces a conflict that is 

20 should not be merged automatically. Existing systems merely select one of these 
altematives. But, without a semantic understanding of the content, the selected 
altemative might be incorrect, and produce an automerge that incorporates changes that 
in fact conflict with other changes.. The inventors have found a situation where an 
additional detection operation allows the present system to inhibit automerging and alert 

25 the user to a possible conflict among multiple changes. 

Fig. 4B shows a method 400 for merging input documents according to the 
invention., so as to recognize the possibility of altemative interpretations. Line 411 
receives the input documents. Block 410 iterates through the changes in the documents. 
30 For each change, block 420 detects the possible existence of altemative histories. If the 
condition does not exist, block 430 merges the changes into the output document. No 
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conflicts arise in this situation. If, on the other hand, the condition is satisfied, then it is 
possible that a change that appears benign might in fact actually be a conflict, hi that 
event, block 440 identifies a conflict in the output document. The user, alerted to this 
possibility, can then resolve whether or not a conflict does in fact exist; alternatively, a 
5 program might resolve the issue and select the correct history. When all changes have 
been processed, method 400 returns the merged output document at line 412. Although 
method 400 increases the amount of human interaction, it decreases errors in the merged 
document, and thus fosters confidence in the automatic merges that the method does 
perform. 

10 

Reversing Changes 

Fig. 5 illustrates a method for "unmerging" according to the invention. There are 
occasions when a user might wish to reverse an operation in a document that has akeady 
been committed to the version store 270, Fig. 2. A change, or a set of changes, has been 

15 checked into a document in the version store, and a user desires to back it out from the 
stored version. For example, a user might wish to reverse a change made between 
version 2 and version 3 from a now current version 4 of a program. Also, a change that 
should be backed out might have already been propagated or promoted to another 
version. Promotion of a change means to apply a change made in one version to the 

20 corresponding document of a subsequent version. An unmerge operation determines 
which changes in a document came from a designated source document, and determines 
which of those changes can be removed safely, and which would cause conflicts if they 
were removed. 

Method 500 performs an unmerge operation. As a working example, suppose that 
25 a file foo.cpp initially is at version 4. User Dick checks in a change in which he changes 
an initiahzation and adds a few lines of code. This becomes version 5. Jane then 
changes the initialization again, and checks in foo.cpp version 6. Later, Alex decides that 
version 7 should not include Bob's changes, but should preserve Jane's modifications. In 
this example, Alex wants to "un-check in" Dick's change. The invention performs this 
30 operation by umnerging version 5 fi*om version 6, using version 4 as a common ancestor. 
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Block 510 receives a designation of a file name, a version number of a desired 
common ancestor, and a version number containing the changes to be removed. Blocks 
520 then performs the reverse of a merge operation. Block 521 detects each difference 
between the received file and the desired source file. Block 522 determines whether the 
5 difference can be removed safely, without introducing an undesired effects. As noted 
above, changes that are independent of other changes in related lines are safe. Block 523 
automatically reverses safe changes. Block 524 identifies conflicts; these are changes 
that caimot be safely reversed because of conflicting intervening changes to the conmion 
ancestor. Users can then review the conflicts and make the appropriate changes. This 
10 example embodiment unmerges a text file. However, the concept of the invention clearly 
extends to unmerging arbitrary other file tj^es, and indeed to unmerging namespace 
changes, just as they have been merged. 



15 Change Sets 

Fig. 6 shows a system 600 for treating changes to multiple arbitrary documents as 
a single unit according to the invention. An important aspect of change management in 
software-development systems involves the concept of a change set. Users often wish to 
treat updates to multiple source files, and updates to the namespace that contains those 
20 files, as a single unit for purposes of tracing changes and applying them. In the past, 
versioned source-code documents could be linked together in a single change set to be 
processed as a unit, but other documents and links were outside the system and had to be 
handled separately. 

In system 600, version store 270, Fig. 2, includes an area called an association 
25 store 610 for holding any number of change-set entities, such as files 620. These file 
contain names by which they are known to system 200, Fig. 2, and entries to documents 
201 that include both versioned code documents 630 and other documents or files 640. 
For example, a change set 621 named 'Issue4335' might relate to a fix for one particular 
problem or disagreement that had arisen in the project. Change set 621 has entries 
30 indicating that changes relating to this issue were made to items 63 1, 633, and 634. The 
hght lines indicate links stored in the entries. Change-set hnks can be made to arbitrary 
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items, such as versioned documents, files outside the version store, even to web pages. 
They can also be links to source changes, such as a delta between two versions, shown at 
633. The latter are not documents as such, and they are tracked by the system. Change- 
set entries can also include system namespace changes, such as adds, renames, deletes, 
5 and shares. 

Further entries indicate that the change set also includes a document 641 
containing a bug report, and a file 643 of design documentation. All of the entries in a 
change set are treated as a unit. Change set 622 has entries designating that version 

10 documents 632 and 634 are to be treated as a unit, along with non- versioned documents 
643 and 645. Change sets can include any type of document or file, in addition to or 
instead of the versioned documents 630. hnage files 642 of screen shots, for instance, 
are included in change sets in exactly the same way as other stored units 640, and in 
exactly the same way as the version documents 630. The change set refers to a delta 

1 5 between versions, and is not itself a version. The change set can contain references to 
any arbitrary items or even to specific versions of items; the delta reference is for code 
changes checked in to the source-code control system. One particular technology for 
reahzing an association store is found in commonly assigned Patent Application Ser. No. 
(Attomey Docket 777.338US1), incorporated herein by reference, 

20 Fig. 7 shows a method 700 for processing the change sets of Fig. 6. To create a 

change set, blocks 710, block 711 receives a specification containing a name to be given 
to the set, and a Hst of items naming the documents and/or files to be included in the set. 
For source changes, this is a set of deltas between two versions of the project. Block 712 
creates a change-set file having the specified name. For each item in the specification, 

25 block 713 causes block 714 to add an entry containing a reference to the designated file 
or document. Block 715 stores it in association store area 610, Fig. 6, although it could 
be stored anywhere. 

Later commands 720 firom a user cause method 600 to perform various actions 
730 upon a change set named in the command. For example, if block 720 receives a user 
30 command to display a certain change set, block 73 1 displays a list of the items in that set. 
Block 732 responds to another command to apply the changes in the specified set. Block 
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733 represents other commands for manipulating the changes in the set. For example, a 
user could view the source changes for an item in the set, displaying the file highhghting 
the changes contained within the set. 

Change sets having files of arbitrary type find additional uses in development 
5 environments that permit branching at the level of entire development projects, such as 

that described in commonly assigned Patent Application Ser. No. 

(Attorney Docket 777,336US1), For example, if a bug is resolved by a fix, applying it to 
a different branch could cause annotations to be made for that bug in that branch. 

10 Concurrent Building and Development 

Figs. 8 and 9 describe additional processing of changes according to the 
invention. Software teams often make reference or master builds of their entire projects at 
firequent intervals — sometimes daily, or even more often — during the development cycle. 
A reference build may provide a basis for a day's work by the entire team. Individual 
15 developers can run tests of their day's changes by overlaying them onto the current 

reference build. If the reference build was certified to pass all tests as of the time it was 
released, then subsequent failures imply that the new changes cause the problems. 

Reference builds have been complex to manage. Source documents are 
synchronized at a designated time such as midnight, and are combined in a build lab. The 

20 completed builds, however, frequently fail one or more of the tests. Temporary fixes 
must then be applied to some source-code documents until the modified build passes all 
the tests. But by that time the developers might already have made modifications to the 
documents that were modified in the build lab. Moreover, it is often difficult for 
developers to incorporate the build-lab fixes without inadvertently picking up other 

25 checked-in changes as well. 

Fig. 8 illustrates a system 800 for managing program-build changes and similar 
temporary modifications made during intervals of a program project. A common area 
810 of version store 270, Fig. 2, holds the versioned documents 811-813 representing the 
source-code files of the project. Another area, reference-build area 820, holds logical or 
30 physical copies 821-823 of the versions of documents 811-813 that have been fi-ozen for 
the current build. In addition, individual developers have their own private copies 830 of 
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the documents in build area 820, or copied or revised jfrom common area 810. Each 
private copy is termed an enlistment 831 or 832. Enlistments are further described in 

Application Ser. No. (Docket 777.335US1). An enlistment generally is 

against common area 810. This means that the common area is a reference base for 
5 anyone who gets files, checks them out, and checks them in. However, the common area 
is not guaranteed to work. Thus, developers wish to fetch files from a known-good build 
area 820 into their enhstment. For example, file 821 — ^which is the build lab's version of 
the common-area file 81 1 — is placed into the enhstment as file 831-1, File 821 might 
incorporate changes from file 811. As well, enhstment file 831-1 might include local 

10 changes that a developer has made. System 800 applies the changes in file 821 to the 
enlistment copy 831-1 so that the developer's local changes are preserved. Thus, an 
individual developer has an environment in an enhstment such as 831 that represents a 
"good build" plus that developer's local changes. When the developer knows that this 
works and has completed all changes, he or she wants to move the changes to common 

15 area 810. Merely checking in the enlistment file would also include the changes that 

were specific to the particular build of the files stored in area 820. To avoid this, system 
800 remembers that the changes in file 821 were apphed to enhstment file 831-1, and 
removes the changes that differentiate file 821 fi*om file 81 1 . Therefore, only the changes 
that were made by the developer to the enlistment file 83 1-1 are apphed to the common- 

20 area file 811 when the enlisted file is checked back in to the common area 810. 

Similarly, a developer can fetch a new version of file 81 1 to enlistment 831. In that case, 
changes in file 821 are removed from copy 831-1, and any new changes to copy 811 are 
apphed. (If the developer gets the latest versions of files from 810 prior to checking in, 
then any errors can be detected in the developer's private area 831 rather than in common 

25 area 810.) Although the copies 831/1-3 and 832/1-3 in each enlistment come fi-om build 
area 820, they return to common area 810, as symbolized by arrows in Fig. 8. 

Fig. 9 shows a process 900 for managing build changes for a single build 
according to the invention. The process is repeated for each build, and concurrently by a 
number of developers. 

30 Blocks 910 synchronize a developer's files. Block 91 1 fetches the latest files for 

that developer from common area 810, Fig. 8 to the appropriate enlistment 830. Block 
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912 merges these files with local changes that the developer had made previously to the 
enlisted files. Blocks 920 convert the enUsted copies of the common-area files into build- 
specific files. Block 921 represents the developer's selection of a desired build to employ 
as a base for changes. Usually, this will be the current build. Block 922 adds the 
5 changes fi-om the desired build. This can be done by comparing common-area files with 
the corresponding build-area files, or alternatively fi-om a hst of changes or some other 
source. Block 923 merges the changes fi-om block 922 into the enhstment copies of the 
files. The developer now has in his or her own enlistment area a current version of the 
files to be updated. 

10 Blocks 930 represent the developer's new local changes. For each change, block 

931 iterates through blocks 932 and 933. The first of these enters the change the 
developer makes into the enlistment copy of one of the files. Block 933 records that 
change, which becomes one of the local changes that are merged in block 912 during the 
next session. When all changes have been completed, in one or more sessions, the 

15 developer checks the files back in, by means of blocks 940. Block 941 unmerges the 
build-specific changes. That is, it removes from the enhstment files the changes that 
were added in block 923. Block 942 then returns the files to common area 810, Fig. 8. 



Conclusion 

20 The present invention offers change management for facilitating the development 

of large and complex software such as operating systems and major applications by 
manipulating versioned documents. Documents can be compared and marked at different 
levels. Potential conflicts from possible alternative histories from a common parent 
document are marked for resolution. Changes from a earlier version are removed from a 

25 later version in the presence of changes from an intervening version. Changes are 

grouped into sets including not only the versioned documents but ancillary nonversioned 
documents as well. A build lab permits parallel development while a build is being run 
and patched, by employing private enhstment stores from which changes are removed 
and applied separately. 
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Claims 



1. A method useful in developing software having multiple versioned documents, 
comprising: 

comparing multiple ones of the versioned documents at a plurality of different 
subdivision levels and indicating the changes on an output document at each subdivision 
level; 

comparing the multiple ones of the versioned documents to a common parent 
document and indicating possible conflicts therebetween caused by alternative histories 
from the parent document; 

unmerging from a later version of one of the versioned documents a set of 
changes previous to a ftirther set of changes; 

associating with the set of changes in the versioned documents a plurahty of 
nonversioned documents pertaining respectively to different versions of the versioned 
documents; 

updating one or more files by copying them from a common storage area to a private 
enhstment area, adding build-specific changes to the enUstment copies, making local 
changes to the modified enlistment copies, and thereafter removing the build-specific 
changes and returning the files to the common area. 

2. A medium bearing representations of computer instructions and data for carrying out 
the method of claim 1 . 



3. A method usefiil in developing software having multiple versioned documents, 
comprising: 

defining at least two nested types of subdivision in both of the documents; 
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for a current subdivision of the first type, comparing a current first-type 
subdivision of one of the documents to a current first-type subdivision of the other 
document, and indicating any differences therebetween; 

for a current subdivision of the second type, comparing a current second-type 
subdivision of one of the documents to a current second-type subdivision of the other 
document and indicating any differences therebetween; 

repeating the second comparing step for further second-type subdivisions of the 
documents within the current subdivision of the first type; 

repeating the first comparing step for further first-type subdivisions within the 
documents; 

producing an output document indicating the differences found in both of the 
comparing steps. 

4. The method of claim 3 further comprising inhibiting the second comparing step when 
the first comparing step detects no difference between the current first-type subdivisions 
of the documents. 

5. The method of claim 3 where the first subdivision type is a line. 

6. The method of claim 3 where the second subdivision type is a character. 

7. A medium bearing representations of computer instructions and data for carrying out 
the method of claim 3. 

8. A method useful in developing software having multiple versioned documents, 
comprising: 

defining at least three nested types of subdivision in both of the documents; 
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for a current subdivision of the first type, comparing a current first-type 
subdivision of one of the documents to a current first-type subdivision of the other 
document, and indicating any differences therebetween; 

for a current subdivision of the second type, comparing a current second-type 
subdivision of one of the documents to a current second-type subdivision of the other 
document and indicating any differences therebetween; 

for a current subdivision of the third type, comparing a current third-type 
subdivision of one of the docximents to a current third-type subdivision of the other 
document and indicating any differences therebetween; 

repeating the third comparing step for further third-type subdivisions of the 
documents within the current subdivision of the second type; 

repeating the second comparing step for further second-type subdivisions of the 
documents within the current subdivision of the first type; 

repeating the first comparing step for further first-type subdivisions within the 
documents; 

producing an output document indicating the differences found in all of the 
comparing steps. 

9. The method of claim 8 fiirther comprising inhibiting the second and third comparing 
step when the first comparing step detects no difference between the current first-type 
subdivisions of the documents. 

10. The method of claim 8 where the first subdivision type is a multi-line section. 



1 1. A method usefiil in developing software having multiple versioned documents, 
comprising: 

comparing two child documents of a common parent document with each other 
and indicating any differences as actual conflicts between the two child documents; 
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comparing both child documents with the common parent document and 
indicating any possible conflicts between the child documents for portions of the child 
documents that are the same as each other; 

producing a merged output document indicating both the actual and the possible 
conflicts. 

12. The method of claim 11 where the possible conflicts represent altemative histories of 
the child documents from the parent document. 

13. The method of claim 1 1 where the possible conflicts are marked in the merged 
document. 

14. The method of claim 1 1 where the actual conflicts are marked in the merged 
document. 

15. A medium bearing representations of computer instructions and data for carrying out 
the method of claim 1 1 . 



16. A method useful in developing software having multiple versioned documents, 
comprising: 

receiving one of said documents at first, second, and third version levels, where 
the third version level incorporates a second set of changes from the second version level, 
and the second version level incorporates a first set of changes from the first version 
level; 

unmerging the first set of changes from the one document at the third version 
level, while preserving the second set of changes; 

outputting the unmerged document 
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17. The method of claim 16 further comprising designating the unmerged document as a 
fourth version level of the one document. 

18. The method of claim 16 further comprising receiving indications of the first, second, 
and third version levels from a user, 

19. A medixmi bearing representations of computer instructions and data for carrying out 
the method of claim 16. 

20. A versioned output document for developing software, the output document 
containing changes from one previous version of the document, but excluding changes 
from another previous version of the same document. 

21. The document of claim 20 where the other previous version of the document is a 
previous version of the one document. 



22. A method useful in developing software having multiple versioned documents, 
comprising: 

associating like versions of the versioned documents with each other in a change- 
set specification; 

associating additional, non-versioned documents into the same change set; 
retrieving both the versioned and nonversioned documents as a single unit. 

23. The method of claim 22 where associating the versioned documents comprises listing 
each of them in an association file. 

24. The method of claim 23 where associating the nonversioned documents comprises 
listing them in the same association file as the versioned documents. 
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25. The method of claim 23 fixrther comprising storing the association file in a memory 
separately from the documents hsted in the file. 

26. A medium bearing representations of computer instructions and data for carrying out 
the method of claim 22. 

27. An association file for a set of versioned documents, comprising: 

a pluraUty of entries each designating a version of one of the versioned 
documents; 

at least one entry designating a nonversioned document pertaining to at least one 
of the versioned documents. 

28. The file of claim 27 where the nonversioned document includes design 
documentation. 

29. The file of claim 27 where the nonversioned document includes bug reports. 

30. The file of claim 27 where the nonversioned document includes screen shots. 

31. A method useful in developing software having multiple versioned documents, 
comprising: 

synchronizing a set of files from a common storage area to a private enlistment 

area; 

adding a set of build-specific changes to the files in the enlistment area; 
making local changes to the enlistment files; 

thereafter, removing the build-specific changes from the enhstment files; 
returning the enlistment files to the common area. 
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32. The method of claim 3 1 further comprising repeating the method for a pluraUty of 
separate private enUstment areas. 

33. The method of claim 32 where the common area is a single area for all of the 
separate enlistment areas. 

34. The method of claim 31 where synchronizing the common-area files includes fetching 
a copy of the common-area files to the private enUstment area. 

35. The method of claim 34 where synchronizing the common-area files further includes 
merging them with a set of previous local changes. 

36. The method of claim 31 where adding the build-specific changes comprises: 

getting the build-specific changes from a build area; 
merging the build-specific changes into the enlistment files. 

37. The method of claim 36 further comprising selecting a particular build fi:om which to 
get the build-specific changes. 

38. A medium bearing representations of computer instructions and data for carrying out 
the method of claim 3 1 . 
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Abstract 

Development of multiple- version software employs versioned documents in a 
store. The documents are compared (differenced) at both line and character levels. 
Potential conflicts in merged documents are marked by detecting possible alternative 
5 histories from a common parent document. Changes from an earlier version are removed 
from a later version of the same document even when the document has intervening 
versions. A build lab allows developers to work in parallel on a new software build while 
another build is being run and patched on a different set of documents; the developers 
each have private copies from which changes pertaining to a build have been added, and 
10 then backed out when the file is returned to a common area. 

"Express Mail" mailing label number: EL7Q9305445US 
Date of Deposit: November 21, 2000 
1 5 This paper or fee is being deposited on the date indicated above v^^ith the United States Postal Service pursuant to 37 
CFR 1 . 1 0, and is addressed to the Commissioner for Patents, Box Patent Application, Washington, D.C. 2023 1 . 
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